<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<!--
This file is part of DisOrder.
Copyright (C) 2009 Richard Kettlewell

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
-->
<html>
 <head>
   <title>Disobedience: Playlists</title>
   <link rel=stylesheet
         type="text/css"
         href="disobedience.css">
 </head>
 <body>
   <h1>5. Playlists</h1>

   <p>The chapter describes playlist and how to use them.</p>

   <h2><a name=what>5.1 What are playlists?</a></h2>

   <p>A playlist is a named list of tracks stored by the server.  It
   can be edit by either just its owner or, alternatively, by all
   users.  It can be played as a unit when required.</p>

   <p>Playlists fall into three categories:</p>

   <table>
     <tr>
       <td><b>Shared</b></td>
       <td>Shared playlists have no owner and can be seen and edited
       by anybody.</td>
     </tr>

     <tr>
       <td><b>Public</b></td>
       <td>Public playlist are owned by their creator and can be seen
       by anybody.  Only their creator can edit them, however.</td>
     </tr>

     <tr>
       <td><b>Private</b></td>
       <td>Private playlists are owned by their creator and can only
       be seen or edited by their creator.</td>
     </tr>

   </table>

   <p>To bring up the playlist window, select <b>Edit > Edit
   Playlists</b> from the menu.</p>

   <h2><a name=creating>5.2 Creating Playlists</a></h2>

   <p>To create a playlist, click the <b>Add</b> button in the
   playlist editor.  This will create a pop-up window where you can
   enter the name of the new playlist and decide whether it is
   shared, public or private.</p>

   <p>Only Roman letters (without any accents) and digits are allowed
   in playlist names.</p>

   <p class=image><img src="playlist-create.png"></p>

   <h2><a name=editing>5.3 Editing Playlists</a></h2>

   <p>You can select the playlist to edit from the left side of the
   window.  Shared playlists are listed first, then the public
   playlists of each user (plus private playlists that you own).</p>

   <p class=image><img src="playlist-window.png"></p>

   <p>When a playlist is selected, you can edit in the right hand half
   of the playlist window.  The editor is very similar in structure
   and function to the <a href="tabs.html#queue">queue</a>.  You can
   rearrange tracks within it by drag and drop and you can drag tracks
   from the <b>Choose</b> tab into it.</p>

   <p>Right clicking will create a pop-up menu which you can use to
   play indivudual tracks or the whole playlist, as well as the
   usual options as found in the <b>Queue</b> tab.</p>

   <p class=image><img src="playlist-popup-menu.png"></p>

   <h2><a name=playing>5.3 Playing Playlists</a></h2>

   <p>There are three ways to play a playlist:</p>

   <ol>

     <li>You can use <b>Control > Activate Playlist</b> from the main
     menu.</li>

     <li>Right clicking in either half of the playlist editor will
     create a pop-up menu.  There is an option to play this
     playlist.</li>

     <li>You can select all the tracks and drag them to the desired
     point in the <b>Queue</b> tab.</li>

   </ol>

   <hr>

   <a href="index.html">Back to contents</a>

 </body>
</html>
